home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glxcreatepbuffer.z / glxcreatepbuffer
Encoding:
Text File  |  2001-04-17  |  8.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX        ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr - create an off-screen rendering area
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      GLXPbuffer ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr( Display *_d_p_y,
  14.                                   GLXFBConfig _c_o_n_f_i_g,
  15.                                   int *_a_t_t_r_i_b__l_i_s_t )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _d_p_y          Specifies the connection to the X server.
  20.  
  21.      _c_o_n_f_i_g       Specifies a GLXFBConfig structure with the desired
  22.                   attributes for the window.
  23.  
  24.      _a_t_t_r_i_b__l_i_s_t  Specifies a list of attribute value pairs, which must be
  25.                   terminated with NNNNoooonnnneeee, or NNNNUUUULLLLLLLL. Accepted attributes are
  26.                   GGGGLLLLXXXX____PPPPBBBBUUUUFFFFFFFFEEEERRRR____WWWWIIIIDDDDTTTTHHHH, GGGGLLLLXXXX____PPPPBBBBUUUUFFFFFFFFEEEERRRR____HHHHEEEEIIIIGGGGHHHHTTTT,
  27.                   GGGGLLLLXXXX____PPPPRRRREEEESSSSEEEERRRRVVVVEEEEDDDD____CCCCOOOONNNNTTTTEEEENNNNTTTTSSSS, and GGGGLLLLXXXX____LLLLAAAARRRRGGGGEEEESSSSTTTT____PPPPBBBBUUUUFFFFFFFFEEEERRRR.
  28.  
  29. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  30.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr creates an off-screen rendering area and returns its
  31.      XID.  Any GLX rendering context that was created with respect to _c_o_n_f_i_g
  32.      can be used to render into this window.  Use ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt to
  33.      associate the rendering area with a GLX rendering context.
  34.  
  35.      The accepted attributes for a GLXPbuffer are:
  36.  
  37.      GGGGLLLLXXXX____PPPPBBBBUUUUFFFFFFFFEEEERRRR____WWWWIIIIDDDDTTTTHHHH     Specify the pixel width of the requested
  38.                            GLXPbuffer. The default value is 0.
  39.  
  40.      GGGGLLLLXXXX____PPPPBBBBUUUUFFFFFFFFEEEERRRR____HHHHEEEEIIIIGGGGHHHHTTTT    Specify the pixel height of the requested
  41.                            GLXPbuffer. The default value is 0.
  42.  
  43.      GGGGLLLLXXXX____LLLLAAAARRRRGGGGEEEESSSSTTTT____PPPPBBBBUUUUFFFFFFFFEEEERRRR   Specify to obtain the largest available pixel
  44.                            buffer, if the requested allocation would have
  45.                            failed. The width and height of the allocated pixel
  46.                            buffer will never exceed the specified
  47.                            GGGGLLLLXXXX____PPPPBBBBUUUUFFFFFFFFEEEERRRR____WWWWIIIIDDDDTTTTHHHH or GGGGLLLLXXXX____PPPPBBBBUUUUFFFFFFFFEEEERRRR____HHHHEEEEIIIIGGGGHHHHTTTT,
  48.                            respectively.  Use ggggllllXXXXQQQQuuuueeeerrrryyyyDDDDrrrraaaawwwwaaaabbbblllleeee to retrieve the
  49.                            dimensions of the allocated pixel buffer. The
  50.                            default value is FFFFaaaallllsssseeee.
  51.  
  52.      GGGGLLLLXXXX____PPPPRRRREEEESSSSEEEERRRRVVVVEEEEDDDD____CCCCOOOONNNNTTTTEEEENNNNTTTTSSSS
  53.                            Specify if the contents of the pixel buffer should
  54.                            be preserved when a resource conflict occurs.  If
  55.                            set to FFFFaaaallllsssseeee, the contents of the pixel buffer may
  56.                            be lost at any time.  If set to TTTTrrrruuuueeee, or not
  57.                            specified in _a_t_t_r_i_b__l_i_s_t, then the contents of the
  58.                            pixel buffer will be preserved (most likely by
  59.                            copying the contents into main system memory from
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX        ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74.                            the frame buffer).  In either case, the client can
  75.                            register (using ggggllllXXXXSSSSeeeelllleeeeccccttttEEEEvvvveeeennnntttt, to receive pixel
  76.                            buffer clobber events which are generated when the
  77.                            pbuffer contents have been preserved or damaged.
  78.  
  79.      GLXPbuffers contain the color and ancillary buffers specified by _c_o_n_f_i_g.
  80.      It is possible to create a pixel buffer with back buffers, and swap those
  81.      buffers using ggggllllXXXXSSSSwwwwaaaappppBBBBuuuuffffffffeeeerrrrssss.
  82.  
  83. NNNNOOOOTTTTEEEESSSS
  84.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr is available only if the GLX version is 1.3 or greater.
  85.  
  86.      If the GLX version is 1.1 or 1.0, the GL version must be 1.0.  If the GLX
  87.      version is 1.2, then the GL version must be 1.1.  If the GLX version is
  88.      1.3, then the GL version must be 1.2.
  89.  
  90.      GLXPbuffers are allocated from frame buffer resources; applications
  91.      should consider deallocating them when they are not in use.
  92.  
  93. EEEERRRRRRRROOOORRRRSSSS
  94.      BBBBaaaaddddAAAAlllllllloooocccc is generated if there are insufficient resources to allocate the
  95.      requested GLXPbuffer.
  96.  
  97.      GGGGLLLLXXXXBBBBaaaaddddFFFFBBBBCCCCoooonnnnffffiiiigggg is generated if _c_o_n_f_i_g is not a valid GLXFBConfig.
  98.  
  99.      BBBBaaaaddddMMMMaaaattttcccchhhh is generated if _c_o_n_f_i_g does not support rendering to pixel
  100.      buffers. (e.g., GGGGLLLLXXXX____DDDDRRRRAAAAWWWWAAAABBBBLLLLEEEE____TTTTYYYYPPPPEEEE does not contain GGGGLLLLXXXX____PPPPBBBBUUUUFFFFFFFFEEEERRRR____BBBBIIIITTTT).
  101.  
  102.  
  103. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  104.      ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiigggg, ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr, ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt,
  105.      ggggllllXXXXSSSSeeeelllleeeeccccttttEEEEvvvveeeennnntttt
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.